package org.example.flea_market_mvc.service.ratings;

import org.example.flea_market_mvc.entity.Ratings;
import org.example.flea_market_mvc.param.RatingParam;

import java.util.List;

/**
 * 用户评价服务接口
 * 处理评价管理业务逻辑，包括评价提交、查询、回复等
 */
public interface RatingsService {

    /**
     * 插入新评价记录
     * @param ratingParam 评价参数对象
     * @return 插入成功返回1，失败返回0
     */
    int insert(RatingParam ratingParam);

    /**
     * 根据评价ID删除评价记录
     * @param id 评价ID
     * @return 删除成功返回1，失败返回0
     */
    int deleteById(Integer id);

    /**
     * 更新评价记录
     * @param ratingParam 评价参数对象（含更新信息）
     * @return 更新成功返回1，失败返回0
     */
    int update(RatingParam ratingParam);

    /**
     * 根据评价ID查询评价记录
     * @param id 评价ID
     * @return 评价实体对象，未找到返回null
     */
    Ratings selectById(Integer id);

    /**
     * 查询所有评价记录
     * @return 评价实体列表
     */
    List<Ratings> selectAll();

    /**
     * 查询用户平均评分（综合多维度）
     * @param userId 用户ID
     * @return 平均星级
     */
    Double getUserAverageRating(Integer userId);
}